Skip to content

Set up Cursor Cloud dev environment for the Ref docs site#27

Draft
MatthewDailey wants to merge 2 commits into
cursor/custom-launchers-documentation-dfaefrom
cursor/setup-dev-environment-042f
Draft

Set up Cursor Cloud dev environment for the Ref docs site#27
MatthewDailey wants to merge 2 commits into
cursor/custom-launchers-documentation-dfaefrom
cursor/setup-dev-environment-042f

Conversation

@MatthewDailey

Copy link
Copy Markdown
Member

Summary

This repository is the Mintlify documentation site for Ref. It has no application backend, no package.json, no database, and no test suite. Setting up the dev environment therefore reduces to installing the Mintlify CLI and running its local preview server.

Changes:

  • Add AGENTS.md documenting the tooling (mint), how to run/preview (mint devhttp://localhost:3000), the closest validation step (mint broken-links), and non-obvious gotchas (authenticated search, pre-existing broken links, no local build/test).

The startup update script installs the CLI globally: sudo env "PATH=$PATH" npm install -g mint.

Verification

  • mint --version4.2.680
  • mint dev serves the docs at http://localhost:3000 (HTTP 200, <title>Welcome! - Ref</title>)
  • mint broken-links runs (reports 2 pre-existing broken links, unrelated to this change)
  • Browser walkthrough: landing page, sidebar navigation to Quick Start, and the Installation page all render correctly.

ref_docs_mintlify_dev_walkthrough.mp4

Ref docs landing page
Ref docs Quick Start page

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

@cursor
cursor Bot force-pushed the cursor/custom-launchers-documentation-dfae branch from b2ee6af to 88bfbea Compare July 9, 2026 22:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants